dragLeave

Type

message

Summary

Sent when the mouse pointer moves out of an object during a drag and drop.

Syntax

dragLeave

Description

Handle the dragLeave message to update a control when the mouse pointer moves outside it during drag and drop.

The dragLeave message is sent only when a drag and drop operation is in progress.

If two controls overlap, a dragLeave message is sent whenever the mouse pointer crosses outside a visible portion of a control. The control on the bottom receives a dragLeave message only when the mouse pointer leaves part of the control that can be seen. A control that is completely hidden by another control on top of it will never receive a dragLeave message.

You can use the dragEnter and dragLeave messages to display a visual cue that shows which control will receive the drop if the user releases the mouse button. For example, the following handlers turn the border of a "droppable" object green while the mouse is over it:

    on dragEnter
        set the borderColor of the target to \"green\"
    end dragEnter

on dragLeave

        set the borderColor of the target to empty
    end dragLeave

Examples

on dragLeave -- remove any outline around the drop no-longer-target
  set the borderColor of the target to empty
end dragLeave

Related

glossary: object, handler, control, mouse pointer, message, drag and drop

message: dragEnter

Compatibility and Support

Introduced

LiveCode 2.0

OS

mac

windows

linux

Platforms

desktop

server